home *** CD-ROM | disk | FTP | other *** search
/ Software of the Month Club 1996 April / Software of the Month Club 1996 April.iso / pc / os2 / psutils / src / readme < prev    next >
Encoding:
Text File  |  1996-02-21  |  10.3 KB  |  233 lines
  1. PostScript Utilities            Angus Duggan              4 April 1995
  2.  
  3. This archive contains some utilities for manipulating PostScript documents.
  4. Page selection and rearrangement are supported, including arrangement into
  5. signatures for booklet printing, and page merging for n-up printing.
  6.  
  7. ENVIRONMENT
  8.  
  9. These utilities have been compiled and run on Sun-3 and Sun-4 machines under
  10. SunOS Solaris 2.3, Solaris 2.1, 4.1.3, 4.1.2, 4.1.1 and 4.0.1, HP9000/375
  11. machines under HPUX 7.0 and HPUX 8.0, Sequent Symmetry machines under Dynix
  12. 3.1.4 and PTX 3.2.0, IBM RS/6000, VAX/VMS, Decstation 3100 machines under
  13. Ultrix 4.0, SGI 4k5 under Irix 4.1 and 5.2, and 486 machines under MSDOS 6.0
  14. and Windows NT 3.5.
  15.  
  16. FILES
  17.  
  18. The files contained are:
  19. -rw-r--r--   1 angus       2270 Apr  4 14:47 LICENSE
  20. -rw-r--r--   1 angus       2699 Apr  4 14:39 Makefile.msc
  21. -rw-r--r--   1 angus       4506 Apr  4 14:39 Makefile.nt
  22. -rw-r--r--   1 angus       4123 Apr  4 14:39 Makefile.os2
  23. -rw-r--r--   1 angus       6370 Apr  4 14:39 Makefile.unix
  24. -rw-r--r--   1 angus      10167 Apr  4 14:39 README
  25. -rw-r--r--   1 angus        585 Apr  4 14:39 config.h
  26. -rw-r--r--   1 angus       2310 Apr  4 14:39 descrip.mms
  27. -rw-r--r--   1 angus       5429 Apr  4 14:39 epsffit.c
  28. -rw-r--r--   1 angus       1210 Apr  4 14:39 epsffit.man
  29. -rw-r--r--   1 angus       1159 Apr  4 14:39 extractres.man
  30. -rw-r--r--   1 angus       2607 Apr  4 14:39 extractres.pl
  31. -rw-r--r--   1 angus        507 Apr  4 14:39 fixdlsrps.man
  32. -rw-r--r--   1 angus       1421 Apr  4 14:39 fixdlsrps.pl
  33. -rw-r--r--   1 angus        473 Apr  4 14:39 fixfmps.man
  34. -rw-r--r--   1 angus        456 Apr  4 14:39 fixfmps.pl
  35. -rw-r--r--   1 angus        587 Apr  4 14:39 fixmacps.man
  36. -rw-r--r--   1 angus       1997 Apr  4 14:39 fixmacps.pl
  37. -rw-r--r--   1 angus        502 Apr  4 14:39 fixpsditps.man
  38. -rw-r--r--   1 angus        551 Apr  4 14:39 fixpsditps.pl
  39. -rw-r--r--   1 angus        469 Apr  4 14:39 fixpspps.man
  40. -rw-r--r--   1 angus       1156 Apr  4 14:39 fixpspps.pl
  41. -rw-r--r--   1 angus        477 Apr  4 14:39 fixscribeps.man
  42. -rw-r--r--   1 angus        336 Apr  4 14:39 fixscribeps.pl
  43. -rw-r--r--   1 angus        499 Apr  4 14:39 fixtpps.man
  44. -rw-r--r--   1 angus        556 Apr  4 14:39 fixtpps.pl
  45. -rw-r--r--   1 angus        493 Apr  4 14:39 fixwfwps.man
  46. -rw-r--r--   1 angus        714 Apr  4 14:39 fixwfwps.pl
  47. -rw-r--r--   1 angus        479 Apr  4 14:39 fixwpps.man
  48. -rw-r--r--   1 angus        589 Apr  4 14:39 fixwpps.pl
  49. -rw-r--r--   1 angus        477 Apr  4 14:39 fixwwps.man
  50. -rw-r--r--   1 angus        284 Apr  4 14:39 fixwwps.pl
  51. -rw-r--r--   1 angus       6124 Apr  4 14:39 getafm
  52. -rw-r--r--   1 angus        711 Apr  4 14:39 getafm.man
  53. -rw-r--r--   1 angus       1035 Apr  4 14:39 includeres.man
  54. -rw-r--r--   1 angus       1312 Apr  4 14:39 includeres.pl
  55. -rw-r--r--   1 angus       1303 Apr  4 14:39 maketext
  56. -rw-r--r--   1 angus      30969 Apr  4 14:39 md68_0.ps
  57. -rw-r--r--   1 angus      35273 Apr  4 14:39 md71_0.ps
  58. -rw-r--r--   1 angus         40 Apr  4 14:39 patchlev.h
  59. -rw-r--r--   1 angus       2598 Apr  4 14:39 psbook.c
  60. -rw-r--r--   1 angus       1084 Apr  4 14:39 psbook.man
  61. -rw-r--r--   1 angus       3013 Apr  4 14:39 pserror.c
  62. -rw-r--r--   1 angus        475 Apr  4 14:39 pserror.h
  63. -rw-r--r--   1 angus        891 Apr  4 14:39 psmerge.man
  64. -rw-r--r--   1 angus       1864 Apr  4 14:39 psmerge.pl
  65. -rw-r--r--   1 angus       9893 Apr  4 14:39 psnup.c
  66. -rw-r--r--   1 angus       3812 Apr  4 14:39 psnup.man
  67. -rw-r--r--   1 angus       5034 Apr  4 14:39 psresize.c
  68. -rw-r--r--   1 angus       1585 Apr  4 14:39 psresize.man
  69. -rw-r--r--   1 angus       5472 Apr  4 14:39 psselect.c
  70. -rw-r--r--   1 angus       1920 Apr  4 14:39 psselect.man
  71. -rw-r--r--   1 angus       7442 Apr  4 14:39 psspec.c
  72. -rw-r--r--   1 angus        803 Apr  4 14:39 psspec.h
  73. -rw-r--r--   1 angus       4795 Apr  4 14:39 pstops.c
  74. -rw-r--r--   1 angus       3895 Apr  4 14:39 pstops.man
  75. -rw-r--r--   1 angus       9064 Apr  4 14:39 psutil.c
  76. -rw-r--r--   1 angus       1376 Apr  4 14:39 psutil.h
  77. -rw-r--r--   1 angus       2567 Apr  4 14:39 showchar
  78.  
  79. PROGRAMS
  80.  
  81. psbook          rearranges pages into signatures
  82. psselect        selects pages and page ranges
  83. pstops          performs general page rearrangement and selection
  84. psnup           put multiple pages per physical sheet of paper
  85. psresize        alter document paper size
  86. epsffit         fits an EPSF file to a given bounding box
  87.  
  88. psselect in modeled after Chris Torek's dviselect program, and pstops is
  89. modeled after Tom Rokicki's dvidvi program. psbook is modeled on my own
  90. dvibook program, which borrows heavily from Chris Torek's dviselect.
  91.  
  92. SCRIPTS
  93.  
  94. getafm   (sh)   outputs PostScript to retrieve AFM file from printer
  95. showchar (sh)   outputs PostScript to draw a character with metric info
  96. fixdlsrps (perl) filter to fix DviLaser/PS output so that PSUtils works
  97. fixfmps  (perl) filter to fix framemaker documents so that psselect etc. work
  98. fixmacps (perl) filter to fix Macintosh documents with saner version of md
  99. fixpsditps (perl) filter to fix Transcript psdit documents to work with PSUtils
  100. fixpspps (perl) filter to fix PSPrint PostScript so that psselect etc. work
  101. fixscribeps (perl) filter to fix Scribe PostScript so that psselect etc. work
  102. fixtpps  (perl) filter to fix Troff Tpscript documents
  103. fixwfwps (perl) filter to fix Word for Windows documents for PSUtils
  104. fixwpps  (perl) filter to fix WordPerfect documents for PSUtils
  105. fixwwps  (perl) filter to fix Windows Write documents for PSUtils
  106. extractres (perl) filter to extract resources from PostScript files
  107. includeres (perl) filter to include resources into PostScript files
  108. psmerge (perl) hack script to merge multiple PostScript files
  109.  
  110. INSTALLATION
  111.  
  112. UUdecode md71_0.uue and md68_0.uue (if supplied encoded). Copy the most
  113. appropriate makefile to "Makefile", and edit the copy to put in required paths
  114. for BINDIR, SCRIPTDIR, MANDIR, INCLUDEDIR, and PERL. Alter values of MANEXT to
  115. put the manual pages in a different section if desired, change PAPER to set
  116. the default paper size, "make", and "make install".
  117.  
  118. BUGS
  119.  
  120. The utilities don't check for PS-Adobe-?.? conformance; they assume documents
  121. conform. Utilities need an extra save/restore around whole document on a
  122. SPARCPrinter with NeWSPrint 1.0, because of bugs in the xnews server.
  123.  
  124. Bug fixes and suggestions to angus@harlequin.co.uk
  125.  
  126. UPDATES
  127.  
  128. The definitive archive site for PSUtils updates is ftp.dcs.ed.ac.uk, in the
  129. directory pub/ajcd/. The latest version will be in psutils.tar.Z, older
  130. versions may also be in psutils-*.tar.Z
  131.  
  132. NOTE
  133.  
  134. This is an interim release; these utilities are currently being re-written
  135. from scratch, with a full DSC-3.0 parser and more extraction, merging, and
  136. inclusion options included.
  137.  
  138. WINDOWS USERS
  139.  
  140. *Please* make sure that you have selected "Generate DSC Comments" in your
  141. printer driver setup. These utilities need DSC comments to tell where page
  142. boundaries are.
  143.  
  144. DVIPS USERS
  145.  
  146. The latest versions of dvips have changed the default setting of the DSC
  147. comment flag; you must generate with DSC comments for PSUtils to work.
  148.  
  149. ACKNOWLEDGEMENTS
  150.  
  151. Bug fixes and suggestions for improvements to PSUtils have come from many
  152. people, including:
  153.  
  154.         Brian Colfer            brianc@labmed.ucsf.edu
  155.         Charles A. Finnell      finnell@org.mitre.lear
  156.         Conrad Kimball          cek@com.boeing.sdc
  157.         J.W.Hawtin              
  158.         Jochen Schwarze         schwarze@de.isa
  159.         Ken Carpenter           khc@edu.ksu.eece
  160.         Kristian Jorg           etxkrjg@se.ericsson.solsta
  161.         Larry Weissman          larryw@nsr.bioeng.washington.edu 
  162.         Michael L. Brown        brown@wi.extrel.com
  163.         Hunter Goatley            goathunter@wkuvx1.bitnet
  164.         John Interrante         interran@uluru.Stanford.edu
  165.         Maurizio Cremonesi      MAUCREM@imiclvx.earn
  166.         Matthew Stier           Matthew.Stier@East.Sun.com
  167.         Gerry Pratt             cca13@seq1.kl.ac.uk
  168.         Robert Joop             rj@rainbow.in-berlin.de
  169.     Johan Vromans        jv@mh.nl
  170.     Bryan Faubion        bryanf@tc.fluke.com
  171.     Chris Ritson        C.R.Ritson@ncl.ac.uk
  172.     Michele Marziani    MARZIANI@VAXFE.INFN.IT
  173.     Michael I. Schwartz    mschwart@diana.cair.du.edu
  174.     Chris Ritson        C.R.Ritson@newcastle.ac.uk
  175.     Joerg Eisenreich
  176.     Anreas Borchert        borchert@mathematik.uni-ulm.de
  177.  
  178. (Apologies to anyone who I have left out, it was not intentional.)
  179.  
  180. NEWS
  181.  
  182. Patchlevel 11 contains some significant enhancements to PSUtils, in
  183. preparation for the eventual release of version 2 (don't hold your breath
  184. waiting for it). These include:
  185.  
  186. * Specify paper sizes by name for pstops and psnup.
  187. * Psnup re-written in C to be much more versatile (do any number n-up).
  188. * Epsffit can input broken %%BoundingBox comments which use real numbers.
  189. * Should work on MSDOS and VMS machines as well as Unix.
  190. * Accept more DSC compliant documents (Page labels are better supported).
  191.  
  192. Patchlevel 12 was a bug-fix release.
  193.  
  194. * Long standing fixmacps bug fixed.
  195. * fixwfwps fixes WFW EPSF files as well as DSC files.
  196. * md71_0.ps and md68_0.ps files were automatically uudecoded.
  197.  
  198. Patchlevel 13 contained two new scripts for resource management, and fixes to
  199. the Makefile, page labels, and output chaining.
  200.  
  201. * Epsffit can output to a file as well as standard output.
  202. * extractres takes resources out of PostScript files and saves them
  203. * includeres puts resources from a resource library into PostScript files.
  204. * maketext script is now used to do substitutions in Perl scripts and man pages
  205. * page labels in psnup and pstops are now show where pages came from.
  206. * page labels in psbook and psselect fixed.
  207. * prologues fixed to be extractable and re-usable
  208. * Makefile doesn't use SUFFIXES any more
  209. * pstops and psnup output can now be chained through each other.
  210. * psresize alters the paper size used by a document
  211. * patchlevel.h shortened to patchlev.h as a concession to MSDOS
  212. * psnup now has -n nup form for compatibility with other n-up programs
  213.  
  214. Patchlevel 14 has some minor bug fixes.
  215.  
  216. * psselect can take end-relative page ranges
  217. * Makefiles restructured to generate machine specific versions from one source
  218. * MSDOS, Windows NT and OS/2 support
  219. * corrections to psbook output for empty pages when rearranging pstops output
  220.  
  221. Patchlevel 15 was a stabilisation release
  222.  
  223. * All code converted to ANSI C, improved error and warning procedures
  224. * Portability fixes in the Makefiles
  225. * psnup can take different sized input and output pages
  226. * Minor fixes to fixwpps script
  227. * psselect reversed pages fixed
  228. * maketext and fix scripts updated for Perl 5
  229.  
  230. Patchlevel 16 was a minor bugfix release
  231.  
  232. * Piped output and input works correctly in NT
  233.